home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1996 February / EnigmA AMIGA RUN 04 (1996)(G.R. Edizioni)(IT)[!][issue 1996-02][Skylink CD III].iso / earcd / faq / fds-310.lha / FindDesc11.lha / FindDesc.doc < prev   
Text File  |  1995-10-25  |  4KB  |  131 lines
  1. @Start_of_text
  2.  
  3.  
  4.                                  FindDesc v1.1
  5.  
  6.  
  7.                                        by
  8.  
  9.                                 Marcus Ohlström
  10.                                and Peter Bornhall
  11.                             (Users Standards Group)
  12.  
  13.  
  14.                             >>> Endorsed by USG <<<
  15.  
  16.  
  17.  
  18.  
  19.                      An extractor for USG file descriptions
  20.                             in any non-archive file.
  21.  
  22.  
  23.  
  24.  
  25.      DISTRIBUTION
  26.     -============-
  27.      The  FindDesc  program and source are Public Domain, and the source may
  28.     be recompiled, changed, enhanced, copied and so on.  Do with it what you
  29.     like.   The  source is ANSI-C, and should compile without problem on any
  30.     ANSI-compliant C-compiler.
  31.  
  32.  
  33.      DISCLAIMER
  34.     -==========-
  35.      This program is provided "as is", without ANY kind of warranty.
  36.  
  37.      The  author  is  in  no  way  responsible for the use or misuse of this
  38.     program,  and  will  not be held liable for any damages arising from the
  39.     use of it.
  40.  
  41.  
  42.      PREFACE
  43.     -=======-
  44.      This  program  is the brainchild of Peter Bornhall and Marcus Ohlström,
  45.     based  on  the  USG-FDS.206  file  description  standard, which allows a
  46.     description to be added to any type of file, regardless of binary, text,
  47.     archive  or  whatever.  This program does NOT handle archives (there are
  48.     already  programs  for  this  available),  but  is  supposed  to extract
  49.     descriptions  from every other type of file.  For information on how the
  50.     descriptions  are  stored inside the file, you should take a look at the
  51.     FDS-310 specifications, available at most well-stocked bulletin boards.
  52.  
  53.  
  54.      USAGE
  55.     -=====-
  56.      This is a very simple program, and this will be brief;
  57.  
  58.  
  59.         Usage: FindDesc infile [outfile]
  60.  
  61.      ...is   the  template  for  FindDesc.   'infile'  is  the  source  file
  62.     containing  the file description, 'outfile' is the optional destination,
  63.     which  will contain the extracted description.  If 'outfile' is omitted,
  64.     STDOUT will be used, which allows the use of FindDesc with pipes.
  65.  
  66.  
  67.         FindDesc FileWithDescription
  68.  
  69.      ...will  scan  the  file 'FileWithDescription' for the description, and
  70.     print  it  to STDOUT if it finds it.  This is useful for easy viewing of
  71.     descriptions.
  72.  
  73.  
  74.         FindDesc FileWithDescription FILEDESC.TXT
  75.  
  76.      ...will  scan  the  file 'FileWithDescription' for the description, and
  77.     save  the resulting (if any) description to a file named 'FILEDESC.TXT'.
  78.     If  FindDesc is unable to open the destination file, it will revert back
  79.     to STDOUT.
  80.  
  81.  
  82.      HISTORY
  83.     -=======-
  84.      Here is a brief history for FindDesc
  85.  
  86.      v1.0  18.11.94  - First public release version.
  87.                        Accompanying the USG-FDS.206 release.
  88.  
  89.      v1.1   27.9.95  - Second public release version.
  90.                        Now even more ANSI-compliant!
  91.                        Accompanying the FDS-310 release.
  92.  
  93.  
  94.      BUGS
  95.     -====-
  96.      No known bugs, but it's the first version...
  97.  
  98.  
  99.      BUG REPORTS
  100.     -===========-
  101.      Should  you  find  any  bugs  in  the  program or in the source, please
  102.     contact  the  author (address below) and explain how they occur, on what
  103.     file (supply it if necessary) and so on.
  104.  
  105.  
  106.      SOURCE
  107.     -======-
  108.      As  stated  above, the source for FindDesc is put in the Public Domain,
  109.     and  may  be  used  by anyone who wishes to use it.  FindDesc is written
  110.     entirely  in ANSI-C and should therefore compile without any problems on
  111.     all ANSI-C compatible compilers.
  112.  
  113.  
  114.      THE AUTHOR(S)
  115.     -=============-
  116.      The  author of this magnificient program/source is Marcus Ohlström, who
  117.     wrote it according to the specifications by Peter Bornhall.  FindDesc is
  118.     a Users Standards Group endorsed software.
  119.  
  120.         Author:   Marcus Ohlström           2:201/417.31@fidonet
  121.                   Stopvägen 104             42:105/106.31@infonet
  122.                   S-16143 BROMMA            marcus@karkis.canit.se
  123.                   SWEDEN
  124.  
  125.         Specs     Peter Bornhall            2:201/417.41@fidonet
  126.         & doc:    Bäck 5, Främmestad        42:105/106.41@infonet
  127.                   S-46598 NOSSEBRO          bornhall@karkis.canit.se
  128.                   SWEDEN
  129.  
  130. @End_of_text
  131.